<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=iso-8859-1">
<title>Building the Examples - The Java EE 5 Tutorial</title>
<meta name="robots" content="index,follow">
<meta name="robots" content="index,follow">
<meta name="date" content="2008-10-01">
<link rel="stylesheet" type="text/css" href="css/default.css">
<link rel="stylesheet" type="text/css" href="css/ipg.css">
<link rel="stylesheet" type="text/css" href="css/j5eetutorial.css">
</head>

<body>

<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
   <tr valign="top">
      <td><p class="toc level1"><a href="docinfo.html">Document Information</a></p>
<p class="toc level1 tocsp"><a href="gexaf.html">Preface</a></p>
<p class="toc level1 tocsp"><a href="gfirp.html">Part&nbsp;I&nbsp;Introduction</a></p>
<p class="toc level2"><a href="bnaaw.html">1.&nbsp;&nbsp;Overview</a></p>
<p class="toc level2"><a href="gfiud.html">2.&nbsp;&nbsp;Using the Tutorial Examples</a></p>
<p class="toc level3"><a href="gexaj.html">Required Software</a></p>
<p class="toc level4"><a href="gexaj.html#gexba">Tutorial Bundle</a></p>
<p class="toc level4"><a href="gexaj.html#gexae">Java Platform, Standard Edition</a></p>
<p class="toc level4"><a href="gexaj.html#gexab">Sun Java System Application Server 9.1</a></p>
<p class="toc level5"><a href="gexaj.html#gexbc">Application Server Installation Tips</a></p>
<p class="toc level4 tocsp"><a href="gexaj.html#gexaz">NetBeans IDE</a></p>
<p class="toc level4"><a href="gexaj.html#gexaa">Apache Ant</a></p>
<p class="toc level3 tocsp"><a href="bnadi.html">Starting and Stopping the Application Server</a></p>
<p class="toc level3"><a href="bnadj.html">Starting the Admin Console</a></p>
<p class="toc level3"><a href="bnadk.html">Starting and Stopping the Java DB Database Server</a></p>
<div class="onpage">
<p class="toc level3"><a href="">Building the Examples</a></p>
<p class="toc level4"><a href="#gexaq">Building the Examples Using NetBeans IDE</a></p>
<p class="toc level4"><a href="#gexah">Building the Examples on the Command-Line Using Ant</a></p>
</div>
<p class="toc level3 tocsp"><a href="gexap.html">Tutorial Example Directory Structure</a></p>
<p class="toc level3"><a href="bnadl.html">Debugging Java EE Applications</a></p>
<p class="toc level4"><a href="bnadl.html#bnadm">Using the Server Log</a></p>
<p class="toc level4"><a href="bnadl.html#bnadn">Using a Debugger</a></p>
<p class="toc level1 tocsp"><a href="bnadp.html">Part&nbsp;II&nbsp;The Web Tier</a></p>
<p class="toc level2"><a href="bnadr.html">3.&nbsp;&nbsp;Getting Started with Web Applications</a></p>
<p class="toc level2"><a href="bnafd.html">4.&nbsp;&nbsp;Java Servlet Technology</a></p>
<p class="toc level2"><a href="bnagx.html">5.&nbsp;&nbsp;JavaServer Pages Technology</a></p>
<p class="toc level2"><a href="bnajo.html">6.&nbsp;&nbsp;JavaServer Pages Documents</a></p>
<p class="toc level2"><a href="bnakc.html">7.&nbsp;&nbsp;JavaServer Pages Standard Tag Library</a></p>
<p class="toc level2"><a href="bnalj.html">8.&nbsp;&nbsp;Custom Tags in JSP Pages</a></p>
<p class="toc level2"><a href="bnaon.html">9.&nbsp;&nbsp;Scripting in JSP Pages</a></p>
<p class="toc level2"><a href="bnaph.html">10.&nbsp;&nbsp;JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="bnaqz.html">11.&nbsp;&nbsp;Using JavaServer Faces Technology in JSP Pages</a></p>
<p class="toc level2"><a href="bnatx.html">12.&nbsp;&nbsp;Developing with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="bnavg.html">13.&nbsp;&nbsp;Creating Custom UI Components</a></p>
<p class="toc level2"><a href="bnawo.html">14.&nbsp;&nbsp;Configuring JavaServer Faces Applications</a></p>
<p class="toc level2"><a href="bnaxu.html">15.&nbsp;&nbsp;Internationalizing and Localizing Web Applications</a></p>
<p class="toc level1 tocsp"><a href="bnayk.html">Part&nbsp;III&nbsp;Web Services</a></p>
<p class="toc level2"><a href="bnayl.html">16.&nbsp;&nbsp;Building Web Services with JAX-WS</a></p>
<p class="toc level2"><a href="bnazf.html">17.&nbsp;&nbsp;Binding between XML Schema and Java Classes</a></p>
<p class="toc level2"><a href="bnbdv.html">18.&nbsp;&nbsp;Streaming API for XML</a></p>
<p class="toc level2"><a href="bnbhf.html">19.&nbsp;&nbsp;SOAP with Attachments API for Java</a></p>
<p class="toc level1 tocsp"><a href="bnblr.html">Part&nbsp;IV&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="bnbls.html">20.&nbsp;&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="bnbnb.html">21.&nbsp;&nbsp;Getting Started with Enterprise Beans</a></p>
<p class="toc level2"><a href="bnboc.html">22.&nbsp;&nbsp;Session Bean Examples</a></p>
<p class="toc level2"><a href="bnbpk.html">23.&nbsp;&nbsp;A Message-Driven Bean Example</a></p>
<p class="toc level1 tocsp"><a href="bnbpy.html">Part&nbsp;V&nbsp;Persistence</a></p>
<p class="toc level2"><a href="bnbpz.html">24.&nbsp;&nbsp;Introduction to the Java Persistence API</a></p>
<p class="toc level2"><a href="bnbrl.html">25.&nbsp;&nbsp;Persistence in the Web Tier</a></p>
<p class="toc level2"><a href="bnbrs.html">26.&nbsp;&nbsp;Persistence in the EJB Tier</a></p>
<p class="toc level2"><a href="bnbtg.html">27.&nbsp;&nbsp;The Java Persistence Query Language</a></p>
<p class="toc level1 tocsp"><a href="bnbwi.html">Part&nbsp;VI&nbsp;Services</a></p>
<p class="toc level2"><a href="bnbwj.html">28.&nbsp;&nbsp;Introduction to Security in the Java EE Platform</a></p>
<p class="toc level2"><a href="bnbyk.html">29.&nbsp;&nbsp;Securing Java EE Applications</a></p>
<p class="toc level2"><a href="bncas.html">30.&nbsp;&nbsp;Securing Web Applications</a></p>
<p class="toc level2"><a href="bncdq.html">31.&nbsp;&nbsp;The Java Message Service API</a></p>
<p class="toc level2"><a href="bncgv.html">32.&nbsp;&nbsp;Java EE Examples Using the JMS API</a></p>
<p class="toc level2"><a href="bncih.html">33.&nbsp;&nbsp;Transactions</a></p>
<p class="toc level2"><a href="bncjh.html">34.&nbsp;&nbsp;Resource Connections</a></p>
<p class="toc level2"><a href="bncjx.html">35.&nbsp;&nbsp;Connector Architecture</a></p>
<p class="toc level1 tocsp"><a href="bnckn.html">Part&nbsp;VII&nbsp;Case Studies</a></p>
<p class="toc level2"><a href="bncko.html">36.&nbsp;&nbsp;The Coffee Break Application</a></p>
<p class="toc level2"><a href="bnclz.html">37.&nbsp;&nbsp;The Duke's Bank Application</a></p>
<p class="toc level1 tocsp"><a href="gexbq.html">Part&nbsp;VIII&nbsp;Appendixes</a></p>
<p class="toc level2"><a href="bncno.html">A.&nbsp;&nbsp;Java Encoding Schemes</a></p>
<p class="toc level2"><a href="bncnq.html">B.&nbsp;&nbsp;Preparation for Java EE Certification Exams</a></p>
<p class="toc level2"><a href="bncnt.html">C.&nbsp;&nbsp;About the Authors</a></p>
<p class="toc level1 tocsp"><a href="idx-1.html">Index</a></p>
</td>
      <td width="10px">&nbsp;</td>
      <td width="705px">
         <div class="header">
             <div class="header-links-top">
                 <a href="http://java.sun.com">java.sun.com</a> |
                 <a href="http://docs.sun.com/">docs.sun.com</a><br>
             </div> 
             <img src="graphics/tutorialBanner.gif" width="704" height="120" alt="The Java&trade; EE 5 Tutorial"/>
             <div class="header-links">
	         <a href="index.html">Home</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/download.html">Download</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/doc/JavaEETutorial.pdf">PDF</a> |
                 <a href="http://java.sun.com/javaee/5/docs/api/index.html">API</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/faq.html">FAQ</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/search.html">Search</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/sendusmail.html">Feedback</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/history.html">History</a>
             </div>
             <div class="navigation">
                 <a href="bnadk.html"><img style="padding-right: 3px" src="graphics/leftButton.gif" border="0"></a>
                 <a href="sjsaseej2eet.html"><img style="padding-right: 3px" src="graphics/upButton.gif" border="0"></a>
                 <a href="gexap.html"><img style="padding-left: 3px" src="graphics/rightButton.gif" border="0"></a>
             </div>
         </div>

	 <div class="maincontent">      	 
             

<a name="bnaan"></a><h3>Building the Examples</h3>
<a name="indexterm-150"></a><p>The tutorial examples are distributed with a configuration file for either NetBeans IDE
or Ant. Directions for building the examples are provided in each chapter. Either
NetBeans IDE or Ant may be used to build, package, deploy, and run
the examples.</p>

<a name="gexaq"></a><h4>Building the Examples Using NetBeans IDE</h4>
<a name="indexterm-151"></a><p>To run the tutorial examples in NetBeans IDE, you must register your Application
Server installation as a NetBeans Server Instance. Follow these instructions to register the
Application Server in NetBeans IDE.</p>
<ol><li><p>Select Tools&rarr;Server Manager to open the Server Manager dialog.</p></li>
<li><p>Click Add Server.</p></li>
<li><p>Under Server, select Sun Java System Application Server and click Next.</p></li>
<li><p>Under Platform Location, enter the location of your Application Server installation.</p></li>
<li><p>Select Register Local Default Domain and click Next.</p></li>
<li><p>Under Admin Username and Admin Password, enter the admin name and password created when you installed the Application Server.</p></li>
<li><p>Click Finish.</p></li></ol>


<a name="gexah"></a><h4>Building the Examples on the Command-Line Using Ant</h4>
<a name="indexterm-152"></a><p><a name="indexterm-153"></a>Build properties common to all the examples are specified in the <tt>build.properties</tt>
file in the <tt></tt><i>tut-install</i><tt>/javaeetutorial5/examples/bp-project/</tt> directory. You must create this file before you
can run the examples. Copy the file <tt>build.properties.sample</tt> to <tt>build.properties</tt> and edit it
to reflect your environment. The tutorial examples use the <a href="http://java.sun.com/reference/blueprints/">Java BluePrints</a> build system and
application layout structure.</p><p>To run the Ant scripts, you must set common build properties in
the file <tt></tt><i>tut-install</i><tt>/javaeetutorial5/examples/bp-project/build.properties</tt> as follows:</p>
<ul><li><p>Set the <tt>javaee.home</tt> property to the location of your Application Server installation. The build process uses the <tt>javaee.home</tt> property to include the libraries in <tt></tt><i>as-install</i><tt>/lib/</tt> in the classpath. All examples that run on the Application Server include the Java EE library archive, <tt></tt><i>as-install</i><tt>/lib/javaee.jar</tt>. in the build classpath. Some examples use additional libraries in <tt></tt><i>as-install</i><tt>/lib/</tt>; the required libraries are enumerated in the individual technology chapters.</p>
<hr><p><b>Note - </b>On Windows, you must escape any backslashes in the <tt>javaee.home</tt> property with another backslash or use forward slashes as a path separator. So, if your Application Server installation is <tt>C:\Sun\AppServer</tt>, you must set <tt>javaee.home</tt> to <tt>javaee.home = C:\\Sun\\AppServer</tt> or <tt>javaee.home=C:/Sun/AppServer</tt>.</p>
<hr>
</li>
<li><p>Set the <tt>javaee.tutorial.home</tt> property to the location of your tutorial. This property is used for Ant deployment and undeployment.</p><p>For example, on UNIX:</p><pre>javaee.tutorial.home=/home/username/javaeetutorial5</pre><p>On Windows:</p><pre>javaee.tutorial.home=C:/javaeetutorial5</pre><p>Do not install the tutorial to a location with spaces in the path.</p></li>
<li><p>If you did not accept the default values for the admin user and password, set the <tt>admin.user</tt> property to the value you specified when you installed the Application Server, and set the admin user&rsquo;s password in the <tt>admin-password.txt</tt> file in the <tt></tt><i>tut-install</i><tt>/javaeetutorial5/examples/common/</tt> directory to the value you specified when you installed the Application Server.</p></li>
<li><p>If you did not use port 8080, set the <tt>domain.resources.port</tt> property to the value specified when you installed the Application Server.</p></li></ul>

         </div>
         <div class="navigation">
             <a href="bnadk.html"><img style="padding-right: 3px" src="graphics/leftButton.gif" border="0"></a>
             <a href="sjsaseej2eet.html"><img style="padding-right: 3px" src="graphics/upButton.gif" border="0"></a>
             <a href="gexap.html"><img style="padding-left: 3px" src="graphics/rightButton.gif" border="0"></a>
         </div>

         <div class="copyright">
      	    <p>The material in The Java&trade; EE 5 Tutorial is <a href='docinfo.html'>copyright</a>-protected and may not be published in other works without express written permission from Sun Microsystems.</p>
      	 </div>

      </td>
   </tr>
</tbody>
</table>
</body>
</html>

